THE CHAOS ENGINE - ATARI STE ENHANCED EDITION
Changelog

VERSION 1.01 - 18 November 2026
- The intro: the Brigand's description had its top line in a pale cyan (seen
  on a real STE); it's white again, the portraits' colours unchanged.

VERSION 1.0 - 14 November 2026
The first release: Beta 3's game, built for any hard disk or GEMDOS drive.
- The workarounds for the SidecarTridge DevOps GEMDRIVE's read bugs are gone
  (a split read, an 8K pad at the top of memory, every file padded to an even
  size): 8K more memory free.
- The testers' F1-F3 keys are gone, and so is the panel split's log to the
  cartridge's debug port.

BETA 3 - 9 November 2026
Third build for release testing: the music and screens between levels as on
the Amiga, the menus' sound effects, new attract demos at 25fps, and the data
packed to 2.7MB.

Music and screens between levels (9 November)
- After a level the screen fades and the level's music plays on while the
  bonus screen loads, then fades as it appears - no LOADING card, as on the
  Amiga.
- The bonus screen's opening tune plays for a bar before its main tune (it
  was never heard).
- After the bonus screen its tune plays on through the next card and fades
  out with it.
- Game over: its opening tune is heard through before fire is taken, as on
  the Amiga (pressing fire early cut it short).
- The attract mode's start: the menu music plays on through the Chaos Engine
  logo, which stays a little longer and fades out with the music.
- No LOADING card between Select Game and the hire screen (the Amiga has
  none there).

Sound effects (9 November)
- The hire screen and the shop make the Amiga's sounds, and Select Players
  and Select Game click when you press fire, as on the Amiga.
- A special power's looping sound stops when its objects are destroyed early
  (it could carry on).

Fixes (9 November)
- Esc at GET READY: no more frame of white noise after the play area fades
  (seen on a real STE).

Speed and size (9 November)
- The data packed: 3.7MB down to 2.7MB. The music and the intro are unpacked
  as they load (Leonard's LZ4 68000 unpacker), about two seconds for a world's
  music behind its card.
- The panel's centre counter is drawn only when it changes: fewer slow frames
  in busy scenes (frames taking over 2 VBLs in the attract demos: about 20%
  down to 16%).

Demos (8 November)
- The level cards say LOADING in small letters at the foot, as on the Amiga.
- The music plays on through a level's card and fades out with it, as on
  the Amiga (it stopped a couple of seconds in).
- Music fades as on the Amiga everywhere: every tune fades in, a tune fades
  out with its screen before the next (the menus, the hire screen, the title,
  Esc from a level), and after a demo its tune plays on through the credits.
- A level fades in as on the Amiga: the play area first, then the panel.
- After F10, the desktop's mouse and keyboard work again (on a real STE
  they could stay dead).
- New attract mode demos, recorded at 25fps: the characters play the levels
  properly again (the ST's demos were recorded at its 16.7fps, so at 25fps
  they drifted off course, wandered about and ended early). Each demo plays
  the same way every time, on any machine.
- The equipment shop after every other demo, and it leaves on time.

Pictures (6 November)
- The mercenary portraits closer to the Amiga's: the brigand's face, hair and
  gun keep more of their shading and colour (no more grey patch beside his
  hair), the thug's background gradients and shoulder keep their tones.

Quit (1 November)
- F10 quits to the desktop, from the intro, the menus or play: the desktop
  comes back with its own resolution, colours and mouse.
- One LOADING card after the intro, up until the menu (it showed twice with
  4 seconds of black between, as the original ST version does).
- The LOADING card in its own colours when the intro is skipped during the
  story text (it kept the text's colours and fade).

BETA 2 - 31 October 2026
Second build for release testing: runs on a 2MB STE, the Amiga's colours in
the intro and end pictures, the intro as the Amiga's.

Intro (31 October)
- The program is CHAOSENG.PRG, in a folder CHAOSENG.STE (was CHAOS.PRG in
  CHAOSE).
- The intro goes round until a button is pressed, as on the Amiga: after the
  last mercenary, back to the story; the title tune fades out at the end of
  each round and starts again with the logo.
- The title tune starts with the logo (it started at the story text).
- Pressing a button fades the music out with the picture.
- The story text rises smoothly from the bottom of the screen through a
  fade, as on the Amiga (it jumped up 8 lines at a time), and sits where the
  Amiga has it (20 lines higher than before).
- Moving the mouse while the game loads no longer shows the busy-bee cursor
  or bits of the desktop, and the screen goes black as soon as it starts.
- The brigand's stray grey pixel by his forehead is gone (and a few like it
  on the other portraits).

Pictures (31 October)
- The intro's beast picture and the six mercenary portraits, and the end
  sequence's screaming face and talking heads, in the Amiga's colours (up to
  32 of them): a new palette every 8 lines, from the STE's 4096 colours.
- The end sequence: the level fades out as on the Amiga (the play area, then
  the panel a second later); no more garbled frames or wrong colours before
  the face; the ST's captions under the heads gone (the Amiga's speech plays
  there now, and the Amiga has none).

Sound (30 October)
- "Level complete" whole after every level: "level" could still be silent
  when an effect had just been cut short on the same voice (a slip in the
  original replayer that the Amiga's sound chip happens to hide). The same
  slip in the music, when an effect hands a voice back, is fixed too.

Memory (30 October)
- Runs on a 2MB STE (was 4MB). The game's own 1MB mode kept a copy of every
  packed file it read, to spare the floppy drive; with files coming from a
  hard drive that copy is gone, and its 476K holds the playfield, tiles and
  map in a level, and the title tune during the intro.
- The music, render and loader parts packed together above 1MB; the loader's
  copy of TOS's memory sized to what TOS uses, at the top of memory.
- The music player's tables trimmed to what they use (85K less).
- The sprite cache uses what's left in both places: on a 2MB machine it is
  about as large as before, and Hatari's 2MB and 4MB STEs draw the attract
  mode frame for frame the same.

Fixes from testers (30 October)
- No more crash (3 bombs) when pressing fire or the mouse button during the
  title music: the intro's end could interrupt the music mixer.
- The level-end speech says "level complete" after every level again: its
  first word could be lost when the music had just used the same voice.
- Sound effects are no longer cut short when the game sets a voice playing
  that is already playing (as the Amiga's sound chip, it now carries on).
- Mega STE: the joystick works again (the game read the STE's pad ports,
  which the Mega STE doesn't have, and took them for a pad in use).

Machines (28 October)
- Mega STE: detected (the cookie jar), switched to 8MHz with the cache off.
- The display set to 50Hz on start (a US machine or EmuTOS starts at 60Hz,
  which made everything run fast).
- A message, and no start, on an ST, TT or Falcon.

Music (28 October)
- Music zones: the in-game tune changes as you move through a level, as on
  the Amiga, switching at the end of a bar.

BETA 1 - 27 October 2026
First build for release testing.

Memory
- The loader's buffers cut from about 1MB to 265K: the TOS and game memory
  are exchanged in place, and files are read straight to where they go
  (loads are quicker too).
- The music and render modules packed together above the loader; the sprite
  cache sized to the memory left. About 2.6MB used in all (was about 3.9MB).
- A clearer message when there isn't enough memory, fitted to low
  resolution.

Fixes from real-STE testing (27 October)
- Music now starts at every level start. It could stay silent when a level
  started that was already in memory (often in the attract mode).
- The music keeps playing through file loads and screen changes (it
  stuttered and lost tempo on the menus and the hire screen).
- The game's files moved into a DATA folder beside CHAOS.PRG.
- The bonus cave in World 1, Level 4 (and any exit back into the same level):
  the old area no longer shows for a second before the new one.

26 October
- Fixed a crash when picking up the winged medallion in World 2, Level 1 (its
  sound effect asked the mixer for a pitch beyond its tables).
- End sequence music, as on the Amiga.
- Bonus screen music: its sting, then its tune (it used to hold a note).
- Teleport dissolves on the blitter's halftone unit.

25 October
- No YM sound: the Amiga's title tune in the intro, its menu music on the
  menu screens.
- The title tune starts at the first story text, as on the Amiga.
- Faster hire and shop screens: their panels drawn by the blitter.
- Faster sprite set-up at level starts; dissolves in one pass.
- The Amiga's sampled sound effects in play.
- Fixes found on the real STE: map tiles and pick-ups redrawn properly,
  small sprites (shots, coins, items), the level start, the panel split.
- Busy scenes faster (sprite glue in assembler, quicker object loops).

24 October
- 25 frames a second with the Amiga's movement speeds and timings.
- Blitter sprites and the hardware-scrolled playfield (AGT).
- In-game music: the Amiga's Richard Joseph tunes through Lance's Paula
  emulator; Jaguar / Power Pad support.
- Loading through GEMDOS from a folder, the game kept at its original
  addresses (TOS swapped in for each file).
